Skip to content

docs(isthmus): javadoc for io.substrait.isthmus type system classes#762

Merged
bestbeforetoday merged 2 commits intosubstrait-io:mainfrom
mbwhite:fix-javadoc-c-008
Mar 25, 2026
Merged

docs(isthmus): javadoc for io.substrait.isthmus type system classes#762
bestbeforetoday merged 2 commits intosubstrait-io:mainfrom
mbwhite:fix-javadoc-c-008

Conversation

@mbwhite
Copy link
Copy Markdown
Contributor

@mbwhite mbwhite commented Mar 18, 2026

No description provided.

@mbwhite mbwhite changed the title fix(javadoc): partial isthmus docs(isthmus): javadoc for io.substrait.isthmus type system classes Mar 23, 2026
Copy link
Copy Markdown
Member

@bestbeforetoday bestbeforetoday left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally good. Just a couple of errors mentioned in comments.

Comment on lines +60 to +64
/**
* Returns the maximum numeric scale supported by this type system.
*
* @return Maximum numeric scale (38).
*/
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This description is incorrect. The parent interface Javadoc says:

/**
   * Returns default precision for this type if supported, otherwise
   * {@link RelDataType#PRECISION_NOT_SPECIFIED}
   * if precision is either unsupported or must be specified explicitly.
   *
   * @return Default precision
   */

Also, the return value (in the current implementation) is 38 for the decimal type, but not for any other type.

Comment on lines +75 to +79
/**
* Returns the maximum numeric precision supported by this type system.
*
* @return Maximum numeric precision (38).
*/
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This description is incorrect. The parent interface Javadoc says:

/**
   * Returns the maximum scale allowed for this type, or
   * {@link RelDataType#SCALE_NOT_SPECIFIED}
   * if scale is not applicable for this type.
   *
   * @return Maximum allowed scale
   */

The maximum scale for the decimal type (in the current implementation) is 38. For all other types it is different.


private final UserTypeMapper userTypeMapper;

// DEFAULT TypeConverter which does not handle user-defined types
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Javadoc below now provides the same information so this line can be removed.

mbwhite added 2 commits March 25, 2026 15:27
Signed-off-by: MBWhite <whitemat@uk.ibm.com>
Signed-off-by: MBWhite <whitemat@uk.ibm.com>
@mbwhite mbwhite force-pushed the fix-javadoc-c-008 branch from d8c7b10 to b59a7df Compare March 25, 2026 15:28
@bestbeforetoday bestbeforetoday merged commit 0ba2178 into substrait-io:main Mar 25, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants